Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 11 - Renderer Objects / Renderer Objects Reference

Renderer Objects Routines / Creating and Managing Renderers

Q3Renderer_Sync

You can use the Q3Renderer_Sync function to ensure that a drawing operation has completed.

TQ3Status Q3Renderer_Sync (
TQ3RendererObject renderer, 
TQ3ViewObject view);

renderer

A renderer.

view

A view.

DESCRIPTION

The Q3Renderer_Sync function waits until the completion of the drawing that is currently being performed by the renderer specified by the renderer parameter in the view specified by the view parameter. If the specified renderer is implemented entirely in software, calling the Q3Renderer_Sync function has no effect. If, however, the specified renderer relies on a hardware accelerator for some or all of its operation, the Q3Renderer_Sync function waits until the renderer is done drawing in the specified view and then returns. In either case, therefore, you can safely perform any operations that depend on the completion of a renderer's drawing after Q3Renderer_Sync returns kQ3Success.

SPECIAL CONSIDERATIONS

Calling the Q3Renderer_Sync function can adversely affect the performance of your application. You should call this function only when you need to know that a drawing operation has completed (for example, if you want to allow the user to select objects in the model by clicking on the model's image on the screen, or if you want to grab a copy of the image on the screen).